home *** CD-ROM | disk | FTP | other *** search
/ Teach Yourself VRML 2 in 21 Days / Teach Yourself VRML 2 in 21 Days.iso / mac / ISO9660 / 3rdparty / POLYTRAN / dos / PT_DOS.ZIP / DOC_1 / EXP_RIB.1 < prev    next >
Encoding:
Text File  |  1996-06-13  |  4.3 KB  |  103 lines
  1. .so psroff.inc        # Include the macros needed for output to Postscript
  2. .TH Export-RIB
  3. .SH NAME
  4. exp_rib \- RenderMan RIB geometry export filter
  5. .SH SYNOPSIS
  6. .PP
  7. This man page describes the options specific to the full featured RenderMan
  8. RIB geometry export converter.
  9. .PP
  10. .SH EXAMPLE CONVERSION SYNTAX
  11. .PP
  12. To convert a 3D Studio file to RIB using the default parameters listed 
  13. in the setup.ini file:
  14. .IP
  15. pt -i 3ds -o rib filename.3ds
  16. .PP
  17. To convert a Lightwave file to RIB and override some of the default options 
  18. in setup.ini:
  19. .IP
  20. pt -i lw -o rib -out-output-texture-data = yes filename.lw
  21. .PP
  22. .SH OVERVIEW
  23. .PP
  24. The RIB geometry export converter writes out the scene database
  25. to a RenderMan RIB v3.1 compliant ASCII file which can then be read into
  26. other programs, or more likely, be sent off to PIXAR's RenderMan
  27. renderer. 
  28. .PP
  29. The converter writes out a full RIB specification that can be read into
  30. a RIB compliant renderer and rendered immediately. It has been tested
  31. with PIXAR's RenderMan for Windows v1.2. The converter primarily outputs 
  32. optimized indexed polygon arrays using the "PointsPolygon" primitive but
  33. will also output NURB and Bicubic patch primitives directly.
  34. .PP
  35. .SH COMMAND LINE OPTIONS
  36. .PP
  37. The following options are specific to this import converter:
  38. .TP
  39. -o rib
  40. This is the mandatory command line option which specifies that the data
  41. is to be exported using the RIB format converter.
  42. .TP
  43. -out-rib-output-txtr-data = [ yes | no ]
  44. If this option is set to 'yes' then texture mapping coordinates ("st" array
  45. data) and texture mapping commands ("MakeTexture") will be output to the
  46. RIB file for those primitives which references 2d textures. If set to 'no'
  47. then no texture mapping related information will be output. 
  48. .TP
  49. -out-line-ending = [ cr | lf | crlf ]
  50. This common option selects which line terminator is to be used for the ASCII output 
  51. file. Files destined for DOS/PC machines should use 'crlf', files for UNIX 
  52. machines should use 'lf' and files for Macintosh machines should use 'cr'.
  53. The default is specific to which machine this converter is presently running
  54. on: 'crlf' for DOS/PC, 'lf' for UNIX and 'cr' for Macintosh. This option
  55. normally does not have to be specified unless you will be using the exported
  56. ASCII file on a different type of computer.
  57. .PP
  58. .SH CONVERSION NOTES
  59. .PP
  60. If NURB or Bicubic patches exist within the converter's internal database
  61. then these will be written to the RIB file as "NuPatch" and "PatchMesh"
  62. primitives, respectively.
  63. .PP
  64. Any other primitives will be written as optimized indexed polygons using
  65. the "PointsPolygon" primitive. If a polygon has holes then it will be
  66. triangulated. If vertex normals, vertex texture coordinates, vertex colors
  67. or vertex opacity values are associated with the polygons then they will
  68. be output as indexed arrays as well ("N", "st", "Cs" and "O" RIB arrays).
  69. .PP
  70. If, within the converter's database, multiple materials are associated with 
  71. a single object then this converter will explode such objects so that each
  72. exported "PointsPolygon" RIB primitive is associated with only one material
  73. definition.
  74. .PP
  75. The exported RIB file contains a line that begins with "# display". This
  76. line should be uncommented if you want the rendered image to be saved
  77. out to the specified TIFF file (see the RIB file for details).
  78. .PP
  79. .SH LIMITATIONS
  80. .PP
  81. No NURB trimming curves are output at this time.
  82. .PP
  83. The exported RIB file references only the "plastic" and "paintedplastic"
  84. default RenderMan shaders. This seriously limits the amount of material
  85. information that can be exported to the RIB file due to the simplicity of
  86. these shaders.
  87. .PP
  88. If more than one texture map is assigned to a surface then only the first
  89. one will be output in the file.
  90. .PP
  91. Texture mapping scale and offset parameters are not output to the RIB file
  92. due to lack of such parameters in the standard RIB shaders.
  93. .PP
  94. No light source decay is output because the standard RenderMan light source
  95. shaders do not support arbitrary decay.
  96. .PP
  97. .SH Other Copyrights and Trademarks
  98. .PP
  99. RenderMan is a registered trademark of Pixar.
  100. .PP
  101. The RenderMan Interface Procedures and Protocol are Copyright 
  102. 1988, 1989, Pixar. All Rights Reserved.
  103.